home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4.zip / Atari Forever 4.iso / SERIE_S / S_909 / GER / FAQ / WINHELP.UI < prev   
Text File  |  1998-03-14  |  6KB  |  144 lines
  1. !subnode Fragen zum WinHelp-Format
  2.  
  3. !begin_description
  4.  
  5. ##################################################
  6.  
  7. !item [WinHelp meint, daβ *.rtf und *.hpj keine Hilfedatei sei?] ~
  8.  
  9. Weder die eine noch die andere Datei ist eine fertige Hifedatei für Windows.
  10. UDO erzeugt lediglich die Quelltexte einer Hilfedatei, welche noch mit einem
  11. Hypertext-Compiler (HC.EXE) übersetzt werden muβ.
  12.  
  13. ##################################################
  14.  
  15. !item [Woher bekomme ich HC31.EXE?] ~
  16.  
  17. (!T)HC31.EXE(!t), der Hypertextcompiler für WinHelp-Dateien, ist meines
  18. Erachtens nicht Freeware. Microsoft und Borland scheinen dieses Programm nur
  19. Ihren Entwicklungssystemen für Windows beizulegen. Es bleibt einem also
  20. nichts anderes übrig, als bei diesen Firmen die Konditionen zu erfragen, zu
  21. denen man dieses Programm auch ohne Entwicklungssystem erhalten kann.
  22.  
  23. ##################################################
  24.  
  25. !item [Warum will der HC einfach keine HLP-Datei erzeugen?] ~
  26.  
  27. Dafür kann es mehrere Gründe geben. In den meisten Fällen liegt es daran,
  28. daβ (!I)Sie(!i) im UDO-Quelltext Fehler gemacht haben, die UDO jedoch nicht
  29. erkannt hat.  Beachten Sie auf jeden Fall auch die Kommentare im zugehörigen
  30. Logile mit der Endung (!T)ulw(!t) und denken Sie immer daran, die Kommandos
  31. (!I)!/begin_document(!i) und (!I)!/end_document(!i) zu benutzen.
  32.  
  33. Falls man den Fehler nicht sofort finden sollte, so hilft es in einigen
  34. Fällen, wenn man am Ende des erzeugten RTF-Files eine oder
  35. mehrere geschweifte Klammern ""}"" hinzufügt.
  36.  
  37. #################################################
  38.  
  39. !item    [Wofür ist die Datei mit der Endung ''hpj''?] ~
  40.  
  41. UDO erzeugt automatisch eine zum Hypertext gehörende Projektdatei mit der
  42. Endung (!T).hpj(!t), die dem HC übergeben werden muβ, um aus dem Quelltext
  43. eine fertige WinHelp-Datei zu erstellen.
  44.  
  45. In dieser Projektdatei befinden sich Informationen wie der Titel des
  46. Hypertextes, die zusätzlichen Schaltflächen, die Ausmaβe des Fensters nach
  47. dem Öffnen des Hypertextes etc.
  48.  
  49. UDO überschreibt vorhandene Projektdateien ohne Rückfrage. Wenn Sie manuelle
  50. Änderungen an einer Projektdatei vorgenommen haben und diese beibehalten
  51. möchten, so schreibschützen Sie die Projektdatei.
  52.  
  53. ##################################################
  54.  
  55. !item    [Wie werden hier die Kopfzeilen erzeugt?] ~
  56.  
  57. UDO erzeugt auf jeder Seite (mit Ausnahme der Titelseite und des
  58. Inhaltsverzeichnisses) eine Kopfzeile. In dieser befindet sich der Name des
  59. jeweiligen Kapitels. Kopfzeilen werden als ""non-scrolling-regions""
  60. angelegt, so daβ man auch nach dem Scrollen der Seite immer noch den
  61. Kapitelnamen erkennen kann.
  62.  
  63. Durch den Schalter ""!/no_headlines~[win]"" werden diese
  64. ""non-scrolling-regions"" nicht erzeugt, beim Scrollen einer Seite wird also
  65. die Kapitelüberschrift mit verschoben.
  66.  
  67. ##################################################
  68.  
  69. !item    [Wie werden die Kontextstrings ermittelt?] ~
  70.  
  71. Falls Sie von anderen WinHelp-Files auf ein mit UDO erzeugtes WinHelp-File
  72. verzweigen möchten, müssen Sie den Kontextstring des Kapitels kennen.
  73.  
  74. WinHelp erlaubt in Kontextstrings keine Sonderzeichen. UDO wandelt daher die
  75. Namen der Kapitel folgendermaβen in Kontextstrings um:
  76.  
  77. !begin_enumerate
  78.  
  79. !item    Zunächst werden wie sonst auch Sonderzeichen durch die
  80.         RTF-Schreibweise ersetzt.
  81.         
  82. !item    Leerzeichen werden in Unterstriche umgewandelt.
  83.  
  84. !item    Alle anderen Zeichen (ausgenommen Ziffern und die Buchstaben des
  85.         Alphabets) werden durch Ihren hexadezimalen Wert in groβer
  86.         Schreibweise mit einem vorangehenden Unterstrich ersetzt.
  87.  
  88. !end_enumerate
  89.  
  90. Ein Beispiel:
  91.  
  92. !begin_quote
  93. !begin_verbatim
  94. UDO:     !node LaTeX-Einführung Teil 1
  95. WinHelp: #{footnote # LaTeX_2DEinf_5C_27FChrung_Teil_1}
  96. !end_verbatim
  97. !end_quote
  98.  
  99. Erläuterungen:
  100.  
  101. !begin_enumerate
  102.  
  103. !item    Das Minuszeichen entspricht ASCII ""(!T)0x2D(!t)"", daher wird es
  104.         durch ""(!T)_2D(!t)"" ersetzt.
  105.  
  106. !item    Das ""ü"" in Einführung lautet in RTF-Schreibweise ""(!T)\'FC(!t).""
  107.         ""(!T)\(!t)"" entspricht ""(!T)0x5C(!t)"", wird also durch
  108.         ""(!T)_5C(!t)"" ersetzt. ""(!T)'(!t)"" enspricht ""(!T)0x27(!t)"",
  109.         wird also durch ""(!T)_27(!t)"" ersetzt.
  110.  
  111. !item    Die Leerzeichen werden durch ""(!T)_(!t)"" ersetzt.
  112.  
  113. !end_enumerate
  114.  
  115. Siehe sehen, daβ aus einem ""ü"" die ziemlich lange Zeichenfolge
  116. ""(!T)_5C_27FC(!t)"" wird. Dies scheint auf den ersten Blick mehr als
  117. umständlich und ""doppelt gemoppelt"" zu sein, bringt aber den Vorteil, daβ
  118. die Vergabe von gleichen Kontextstrings bei ähnlichen Kapitelnamen ziemlich
  119. unwahrscheinlich wird. Würde aus dem ""ü"" lediglich ""FC"" gemacht, wären
  120. Probleme vorprogrammiert.
  121.  
  122. ##################################################
  123.  
  124. !item [Warum werden Tabellen nicht zentriert?] ~
  125.  
  126. Entweder ist dies wirklich nicht möglich, Tabellen zentriert auszugeben,
  127. oder aber ich habe bei meiner viertägigen Suche die entscheidende
  128. Möglichkeit übersehen.
  129.  
  130. ##################################################
  131.  
  132. !item [Warum sind die Einrückungen bei Listen und Tabellen so groβ?] ~
  133.  
  134. UDO kennt die Zeichenbreiten der benutzten Zeichensätze nicht. Daher benutzt
  135. es einen konstanten Wert für jedes Zeichen. Damit ist die Einrückung auch
  136. bei kursiver fetter Groβschrift passend, bei reiner Proportionalschrift ist
  137. die Einrückung und auch die Breite der Tabellenspalten etwas zu groβ, was
  138. jedoch eher zu verschmerzen ist, als eine zu geringe Einrückung oder
  139. Spaltenbreite.
  140.  
  141. ##################################################
  142.  
  143. !end_description
  144.